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(57) ABSTRACT 

A method and system for adding application defined prop- 
erties and application defined property sheet pages are 
provided. The application defined properties may be added 
to a list of system defined properties. Once added, the 
application defined properties may be displayed and edited. 
In addition, a user may select several object, display the 
properties common to all of the objects in a list, and edit the 
common properties. Moreover, application defined property 
sheet pages may be added to a set of system defined property 
sheet pages. A user may then display and edit the app lication 
defined property sheet pages._A lso, a user may select several 
objects, display the properties common to all of the objects 
on a per-property browsing list, and edit the common 
properties. In addition, a user may select several objects, 
display the property sheet pages common to all of the 
objects, and edit the properties on these property sheet 
pages. Furthermore a user may switch between viewing a 
property in a list of properties and viewing a property on a 
property sheet page. 

22 Claims, 14 Drawing Sheets 
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METHOD AND SYSTEM FOR ADDING 
APPLICATION DEFINED PROPERTIES AND 
APPLICATION DEFINED PROPERTY SHEET 
PAGES 

This application is a continuation of U.S. Ser. No. 
09/231,719, filed Jan. 15, 1999, now U.S. Pat. No. 6,208, 
337, which is a continuation of U.S. Ser. No. 08/886,110, file 
Jun. 30, 1997, now U.S. Pat. No. 6,304,258, which was a 
divisional of U.S. Ser. No. 08/413,396 filed Mar. 30, 1995, 
now U.S. Pat. No. 5,682,510, issued Oct. 28, 1997. 

TECHNICAL FIELD 

The present invention relates generally to data processing 
systems and, more particularly, to displaying and editing 
properties of an object 

BACKGROUND OF THE INVENTION 

Objects often have properties associated with them. A 
property defines an aspect of a state of an object For 
instance, a label for a form may be represented as an object, 
and the label object may have a "Font Name" property that 
identifies the font of the text contained in the label. A 
property also has an associated type, such as string or 
integer. An object typically has system defined properties 
associated with it. System defined properties are properties 
whose types are defined by the system. An object may also 
have application defined properties associated with it. Appli- 
cation defined properties are properties whose types are 
defined by an application developer. An application devel- 
oper also defines an object and properties associated with the 
object 

Current systems enable a-user to display and edit system 
defined properties of an object, such as the "Font Name" 
property. Some systems offer the per-property browsing 
method which allows display and editing of system defined 
properties which appear in a list, as illustrated in FIG. 1. 
Other systems offer the property sheet page method which 
allows display and editing of system defined properties 
which appear on system defined property sheet pages as 
illustrated in FIG. 2. System defined property sheet pages 
are property sheet pages which are defined by the system. 

The per-property browsing method displays all system 
defined properties of one object on a list, typically in 
alphabetical order. For instance, in FIG. 1, a list of properties 
for a label object is depicted. One property name "Font 
Name" is shown along with the current value "Roman." This 
method enables a user to find a particular property by 
searching the list for the system defined property. For 
example, a user would search through the fist illustrated in 
FIG. 1 to find the property name "Font Name." 

The property sheet page method groups system defined 
properties into logical subsets which are displayed on sys- 
tem defined property sheet pages on a per object basis. Each 
system defined property sheet page may be used to display 
or edit a portion of the state of an object. For example, in 
FIG. 2, the "Font" group is illustrated on a system defined 
property sheet page for a label object, along with the 
property names "Font Name" and "Font Size." FIG. 2 shows 
that the current state of the object is a "Roman" font name 
with size 12 print. Also, the method enables a user to find a 
particular system defined property by requesting the group 
that includes the system defined property. For example, the 
method enables a user to find the property name "Font 
Name" by requesting the "Font" group. 

Additionally, objects generally have system defined prop- 
erties associated with them. Some objects also have appli- 
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cation defined properties associated with them. Some cur- 
rent systems are limited in their capabilities in that they do 
not provide display and editing of application defined 
properties, although they provide display and editing of 

5 system defined properties. 

Some conventional systems lack the ability to provide 
multiple selection. That is, some conventional systems allow 
for display and editing of properties of a single object. When 
several objects have common properties which a user wishes 

10 to edit, the user selects each object and edits its property 
separately. With multiple selection, however, a user may 
display and edit the common properties of several objects at 
one time. 

Also, conventional systems do not provide the ability to 
15 switch between the per-property browsing and property 
sheet page methods. Some users may prefer one method 
over the other. Also, sometimes, a user may prefer to use one 
method and then switch to the other method. Therefore, a 
user should be able to switch between the per-property 
20 browsing and property sheet page methods. 

SUMMARY OF THE INVENTION 

The above-described difficulties encountered by conven- 

25 tional systems are overcome by the present invention. In 
accordance with a first aspect of the present invention, a 
method is practiced in a data processing system that includes 
a video display and a processor that runs an application 
program. The data processing system also includes an oper- 

3 q ating systemMrtiaj^clud^^ browser. In this 

method , ariobject with-associated;system 
is^proviclecl^lis't of system*defined prbpertieTis^spilayed-^ 
on the videQ_display.-An-object-with-an-associated applica- 
tion defined property is provided. An identifier to an appli- 

35 cation defined property type that is defined by the applica- 
tion program is obtained. A current value for the application 
defined property is obtained The identifier of the application 
defined property type and the current value for the applica- 
tion defined property are added to the list of system defined 

40 properties displayed on the video display. 

In accordance with a further aspect of the present 
invention, a data processing system includes a video display, 
and a processing means running an operating system and an 
application program A list of system defined properties is 

45 also included in the data processing system. In this system, 
a means for displaying a list of system defined properties on 
the video display is provided. Also, a means for providing an 
object with an associated application defined property is 
included in the system. A means for obtaining an identifier 

50 to an application defined property type defined by the 
application program is provided. The system also includes a 
means for obtaining a current value for the application 
defined property. A means for adding the identifier of the 
application defined property type and the current value for 

55 the application defined property to the list of system defined 
properties displayed on the video display is provided. 

In accordance with an additional aspect of the present 
invention, a method is practiced in a data processing system 
having a video display, a processor running an operating 

60 system, and a per-property browsing list. In this method, an 
object with an application defined property is provided. 
Code for a function is called to obtain the type of the 
application defined property. Code for a function is called to 
obtain the current value of the application defined property. 

65 The type and current value of the application defined prop- 
erty are added to the per-property browsing list, in accor- 
dance with another aspect of the present invention, a method 
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is practiced in a data processing system that includes a video FIG. 6 is an example of a user interface in which an 

display and a set of system defined property sheet pages. An application defined property sheet page is generated in 

operating system that includes a property sheet page browser accordance with the preferred embodiment of the invention, 

for browsing property sheet pages is also included in the data FIG ? is an example of a user interface in which a 

processing system In this method an object and an asso- 5 w^dow containing menu options is displayed in accordance 

ciated application denned property sheet page tor the object ^ ^ ^ embodiment of the invention, 

are provided. The application defined property sheet page is r 

added to the set of system defined property sheet pages FIG - 8 is a flowchart that provides an overview of the 

displayed on the video display. The set of system defined ste P s performed to add application defined properties to a 

property sheet pages is browsed using the property sheet JQ per-property browsing list for an object, 

page browser. FIG. 9 is a flowchart of the steps performed by the 

In accordance with yet another aspect of the present per-property browser when either the drop down list button 

invention, a data processing, system includes a processing or the property sheet page map button have been activated, 

means for running an operating system, a video display, and FIG. 10 is a flowchart of multiple selection within per- 

a set of system defined property sheet pages. The system propert y browsing 

provides means for displaying the set of system defined 1S ^ ' 4 , 

property sheet pages. The system also provides means for FI 9 11A / od FIG ' UB s how a flowchart that provides an 

providing an object with an associated application defined overview of the steps performed to add application defined 

property sheet page. The system further provides means for property sheet pages to a set of system defined property 

adding the application defined property sheet page to the set sheet pages for an object. 

of system defined property sheet pages displayed on the 20 . FIG. 12 is a flowchart that provides the steps performed 

video display. to edit an application defined property sheet page. 

In accordance with an additional aspect of the present FIG. 13 is a flowchart of the property sheet page browser 

invention, a method is practiced in a data processing system wnen { X enables switching from application defined property 

that includes a video display. In this method, a plurality of sheet pages to a per-property browsing list, 

objects, each having associated application defined 25 piG u fe nowchATi of multi le selection within 

properties, are received. The common application defined , r r 

properties of the different objects are determined. The com* proper y rowsing. 

mon application defined properties are displayed on a per- FIG. 15 is a flowchart of multiple selection by a property 

property browsing list on a video display. sheet page browser. 

In accordance with another aspect of the present 30 DETAILED DESCRIPTION OF THE 

invention, a method is practiced m a data processing system INVENTION 
that includes a video display In this method, a plurality of 

objects, each having associated property sheet pages, are The preferred embodiment of the present invention 

received. The method determines whether the objects have extends the capabilities of the per-property browsing method 

common property sheet pages. When the objects have com- 35 by allowing a user to display and edit application defined 

mon property sheet pages, the method displays the common properties for an object In addition, the preferred embodi- 

property sheet pages on a video display. ment ena ^s^niser'to's elecrseyefo 

In accordance with yet another aspect of the present \ properties'commorT toliiroTthe ofij eclTin^te 

invention, a method is practiced in a data processing system jBei^M 

that includes a video display and an operating system that 40 capabilities of the property sheet page method by allowing 
includes a per-property browser and a property sheet page a user to display and edit application defined property sheet 
browser. An application defined property is provided A pages. Also, the preferred embodiment of the present inven- 
per-property browsing list having an entry for the applica- tion enables a user to select several objects, to display the 
tion defined property is provided A property sheet page property sheet pages common to all of the objects, and to 
browser having a property sheet page for the application 45 edit properties on the displayed property sheet pages. Fur- 
defined property is provided. When receiving user input thermore the preferred embodiment enables a user to switch 
indicating a desire to switch from the per-property browser between the per-property browsing and property sheet page 
to the property sheet page browser, the method maps to a methods. 

property sheet page. When receiving user input indicating a The preferred embodiment of the present invention is 

desire to switch from the property sheet page browser to the 50 practiced in an object-oriented environment that supports the 

per-property browser, the method maps to a property sheet Microsoft OLE 2.01 protocol developed by Microsoft Cor- 

page containing a per-property browsing list poration of Redmond, Washington. In order to fully under- 

BRIEF DESCRIPTION OF THE DRAWINGS stand the preferred embodiment of the present invention, it 

is helpful to review some of the fundamental concepts 

FIG. 1 is an illustration of a user interface in which a $$ emp i oye d within Microsoft OLE 2.01. 

conventional per-property browsing list is displayed. ^ « object dass „ is the defimtion of 5olh a data structure 

FIG. 2 is an illustration of a user interface in which a and functions that manipulate the data structure. An "object" 

conventional property sheet page is displayed. ^ an i mi ^ nCQ 0 f m object class. An "interface" is a group of 

FIG. 3 is a block diagram of a computer system which is semantically related functions that are organized into a 

suitable for practicing the preferred embodiment of the 60 name d unit. The name of the unit is the identifier of the 

present invention. interface. Interfaces have no instantiation in that the inter- 

FIG. 4 is an example of a user interface in which a face does not include code for implementing the functions 

per-property browsing list is displayed in accordance with that are identified in the interface; rather, the interface 

the preferred embodiment of the invention. specifies a set of signatures for functions. "Instantiation" 

FIG. 5 is an example of a user interface in which a 65 refers to the process of creating in-memory structures that 

per-property browsing drop down list is displayed as it represent an object so that the operations can be invoked on 

appears in the preferred embodiment of the invention. the object. When an object "supports" an interface, the 
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object provides code for the function specified by the list 24 by a single element, either up or down, a user may use 

interface. Hence, an object that supports an interface is a mouse to point at the scroll up arrow 35 or scroll arrow 

responsible for providing the code for implementing the down 36 and click a designated mouse button. Additionally, 

functions of the interface. The code that is provided by the if a user uses a mouse to point at the scroll up arrow 35 or 

object must comply with the signatures specified by the 5 scroll down arrow 36, and keeps the mouse button 

interface. depressed, the scrolling continues until the mouse button is 

FIG. 3 is a block diagram of a computer system 1 which released. This allows a user to quickly scroll through the 
is suitable for practi cing the preferred em bodiment of the per-property browsing list 24. An element may be selected 
present inv ention. Tfiee^com p^ from the per-property browsing list 24 by pointing at it with 
trll^r^es^gjinit (CPU) 2 Sat is connected to^a^humber 10 a mouse 4 and clicking a designated mouse button. For the 
of input/output llevicesrincluding mouse 4, keyboard 10, following discussion, "mouse" will be used in place of "user 
and video display 12. The computer system 1 also includes pointing device," but one skilled in the art would appreciate 
a network interface 6 for interfacing the computer system that other user pointing devices would be equivalent 
with a network. Memory 8 stores data and code. Specifically, After selecting a property, a user may activate the prop- 
memory 8 holds a copy of an operating system, objects, a 15 erty sheet page map button 32 to switch to a corresponding 
per-property browser, and a property sheet page browser. A property sheet page that displays values of the property 
bus 14 connects the components of the computer system. group containing the selected property. The, property sheet 

Before discussing the code and structures used to facili- page map button 32 may be activated by using a pointing 

tate the code, the user interface will be discussed. device, such as a mouse 4, to point at the property sheet page 

Specifically, FIGS. 4-7 represent sample user interfaces 2 o ma P button 32 and by entering a user selection indicator, 

producing an illustrative embodiment of the present such as a click on a designated mouse button. In addition, a 

invention, which will be described before the flowcharts of user may activate the drop down list button 30 to view a drop 

FIGS. 8-5 are discussed. down list, which contains other possible values for the 

FIG. 4 is an example of a user interface in which a selected property. Any drop down list button may be acti- 

per-property browsing list 24 is displayed in accordance 2 5 vated just as the property sheet page map button is activated, 

with the preferred embodiment of the invention. The user FIG. 5 is an example of a user interface in which a 
interface includes a per-property brows er 22 that enablesT? per-property browsing drop down list 37 is displayed as it 

fuseT kf browse the current property values associat^^tF appears in the preferred embodiment of the invention. A 

properties* of **an^object. ^Tne~per-property~browseT 22 is drop down list 37 is displayed when the drop down list 

within a^window '20 that is produced by a development 30 button 30 has been activated for a particular property. The 

environment The development environment is a set of drop down list 37 shows other possible, values for the 

resources made available to the user of a system which property. For instance, when the property name 26 is "Font 

includes code providing system defined interfaces. The Name" and the current property value is "Roman" 28, the 

per-property browser 22 is part of the development drop down list 37 indicates that other possible values include 

environment, and it provides the framework with which a 35 "Modem" and "Script" By using the scroll bar 38, as 

per-property browsing list 24 is displayed. Each element in discussed above, or by depressing the page up or page down 

the per-property browsing list 24 includes a property name keys on the keyboard 10, a user may scroll through the 

26, a current property value 28, a drop down list button 30, possible values. An element may be selected from the drop 

and a property sheet page map button 32. The per-property down list 37 by pointing at it with a mouse 4 and clicking 

browsing list 24 has system defined properties. The per- 40 a designated mouse button. In addition, an element may be 

property browser 22 enables a user to add application selected by depressing the arrow keys on the keyboard 10 in 

defined properties to the per-property browsing list 24. Then, order to move to the desired element When an element is 

the per-property browser 22 displays both the system selected from the drop down list 37, the element replaces the 

defined properties and the application defined properties in current property value. For instance, if the element "Mod- 

the per-property browsing list 24. For instance, the per- 45 era" were selected, it would replace "Roman" as the current 

property browsing list 24 has the property name 26 "Font property value. In the following discussion, each drop down 

Name" and the current property value 28 "Roman." list may be scrolled in this manner and elements in the drop 

A user may search through the per-property browsing list down list may be selected as described here. 

24 by depressing arrow keys on the keyboard 10. As the user FIG. 6 is an example of a user interface in which an 

depresses the arrow keys, the currently selected property is 50 application defined property sheet page 44 is generated in 

incremented so that the next property in sequence is accordance with the preferred embodiment of the invention, 

selected. A visual cue to the user, such as highlighting, is A property sheet page browser 42 is within a window 40. 

generally provided to identify the currently selected prop- The property sheet page browser 42 is part of the develop- 

erty. In addition, a user may search through the per-property ment environment, and it provides the framework within 

browsing list by using the scroll bar 33. The scroll bar 33 has 55 which an application defined property sheet page 44 displays 

a scroll box 34, a scroll down arrow 35, and a scroll up arrow itself The property sheet page browser 42 contains a tab 45 

36. In order to use the scroll bar 33, the user points at the which identifies a property group. For instance, tab 45 

scroll box 34 with a user pointing device, such as a mouse indicates that the property sheet page is the "Font" property 

4, and while pointing at the scroll box 34, enters a user group. Other tabs 46 are also displayed alongside tab 45 in 

selection indicator, such as a click of a designated mouse 60 such a way that the display resembles a set of tabbed index 

button. Then, while keeping the mouse button depressed, the cards. The other tabs 46 represent other property groups 

user may drag the scroll box 34, up or down, to view associated with a particular object The application defined 

different portions of the per-property browsing list 24. A property sheet page 44 contains various properties of an 

mouse is a user pointing device, which has one or more object which may be displayed and edited. For example, the 

mouse buttons, and clicking on a mouse button outputs a 65 "Font" property group 45 has property names "Font Name" 

user selection indicator which selects the element pointed at 47 and "Font Size" 52. The property name "Font Name" 47 

by the mouse. In order to scroll the per-property browsing has a current property value 48 and a drop down list button 
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49. When the drop down list button 49 for "Font Name" is property (step 70) by using the Typelnfo interface defined by 

activated by a user, the drop down list 50 for "Font Name" Microsoft OLE 2.01 and implemented by an object. Then, 

47 is displayed. The drop down list 50 shows other possible the per-property browser calls the Querylnterface ( ) func- 

values for the "Font Name" property. Similarly, the property tion on the object that has the application defined property 

name "Font Size" 52 has a current property value 53 and a 5 to obtain a pointer to the IPerPropertyBrowsing interface 

drop down list button 54, which when activated displays a provided by the present invention (step 72). The IPerProp- 

drop down list with other possible size values. In addition erty Browsing interface is defined as follows in C++, 

the property sheet page browser 42 has an OK button 55, a interface IPerPropertyBrowsing: IUnknown 

CANCEL button 56, and an APPLY button 57. Each button { 

may be activated as the drop down list button is activated. 1Q GetDisplayString(DISPID dispid, BSTR FAR* lpbstr); 

Additionally, a user may select one of these buttons using a MapPropertyToPage(DISPID dispid, LPCLSID lpclsid); 

tab key to move to the button, and a user may activate the GetPredefinedStrings(DISPID dispid, CALPOLESTR 

button by depressing the enter key on the keyboard 10. The FAR* IpeaStringsOut, CADWORD FAR* 

OK button applies any modifications the user made while lpcaCookiesOut)* 

C ^Lft Cl0Se I the pr ° per , ty Sh6et 2f brOWS f 71,6 15 GetPredefinedValue'(DISPID dispid, DWORD dwCookie, 

CANCEL button does not apply any modifications the user VARIANT FAR* lpvarOutV 

made while editing and closes the property sheet page 1. 

browser The APPLY button applies the modifications the ^ e ^©^,8^ ( ) funclion retrieves a character 

user made while editing the property sheet page to the strf representing the current value of the application 

object or objects associated with the application defined 2Q defiDed pK)perty lQ be displayed ^ MapPropertyToPage 

property sheet page. ^ ^ — ^ ^ function enables switching from a per-property browsing 
/SOTM?^ / list to a property sheet page containing the particular prop- 

Lwiiriow!60,cbn^ erty. In particular, this function maps the property to a 

dance with the preferred embodiment of the invention. The property sheet page. The GetPredefinedStrings ( ) function 

window 60 contains a menu bar 62 with a number of menu 25 and GetPredefined Value ( ) function return possible values 

options. A user may select the "File" menu 64. When the for a p roper ty, along with display names for the values. 

"File" menu is selected, a drop down menu 66 is shown. The M{er obtaining the pointer to the IPerPropertyBrowsing 

drop down menu 66 contains elements relating to a file, interface, the per-property browser calls the GetDisplay- 

including the element Properties 68. A user may select an String ( ) function to obtaia the current property value of the 
element in a drop down menu in the same manner as jtn property (step 73). Once the per-property browser has the 
sde^i^nelement in a drop down list. Auserteay selectl property type and property value, the per-property browser 

(Jgpperties^ can add these application defined properties to a per- 

jjmj^fopeiflies property browsing list along with system defined properties 

/^iPCQP g ^ (step 74). 

Cmgtn^^ 35 pig. 9 is a flowchart of the steps performed by the 

'Now-that-the-u^r-mterfaces-have-been-discussed, the per-property browser when either the drop down list button 

following discussion will be directed to code. First, or tne property sheet page map button have been activated, 

however, it may be useful to discuss the interfaces that First, the per-property browser receives user input which 

enable per-property browsing and property sheet page indicates which step the per-property browser should take 

browsing. The per-property browser calls the IPerProperty- 40 next (step 80). Then the per-property browser determines 

Browsing interface. The object having application defined whether the user input is a request to activate a drop down 

properties supports the IPerPropertyBrowsing interface. The list button, which indicates a desire to view the drop down 

property sheet page browser calls the ISpecifyPropertyPages ii st (step 82). If the user input requests activation of the drop 

interface, the IPropertyPage interface, and the IPropertyPag- down list button, then the per-property browser calls the 

eSite interface. An application defined property sheet page 45 GetPredefinedStrings ( ) function to obtain character strings 

supports the IPropertyPage and the IPropertyPageSite inter- corresponding to the possible values of the property (step 

faces. An object supports the ISpecifyPropertyPages inter- 84). Then the drop down list is displayed (step 86). If the 

face. These interfaces will be discussed below. use r input is not a request to activate the drop down list 

Before discussing the interfaces used by the per-property button, then the per-property browser determines if the user 

browser and property sheet page browser, it is useful to 50 input is a request to select an element in a drop down list 

review some fundamental concepts of the Microsoft OLE which is already displayed (step 88). If the user input is a 

2.01 protocol. IUnknown is an interface that all objects must request to select an element, then the per-property browser 

support by definition to comply with Microsoft OLE 2.01. calls the GetPredefinedValue ( ) function to obtain the value 

One function identified in the IUnknown interface is the corresponding to the user's choice (step 90). Then this value 

Querylnterface () function. When called, the Querylnterface 55 replaces the current property value (step 91). For example, 

function retrieves a pointer to an interface that is identified if the per-property browser receives user input requesting 

by an input parameter that is passed to the function. By using activation of the drop down list button for a color property, 

the Querylnterface () function on an object, the per-property which allows selection of a color for text, then the per- 

browser and the property sheet page browser can switch property browser calls the GetPredefinedStrings ( ) function, 

between interfaces provided by that object, and thus call 60 The GetPredefinedStrings ( ) function may return character 

functions within the different interfaces supported by that strings such as "Red " "Blue," and "Green," which corre- 

object in order to provide per-property browsing and prop- spond to possible values of the color property. When the user 

erty sheet page browsing on that object. selects one of these character strings, such as "Red," the 

FIG. 8 is a flowchart that provides an overview of the per-property browser calls the GetPredefinedValue ( ) func- 

steps performed to add application defined properties to a 65 tion. The GetPredefinedValue ( ) function returns the actual 

per-property browsing list for an object. The per-property value corresponding to the selected character string, such as 

browser first obtains the type of the application defined an RGB value for the selected color "red." 
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Continuing with the flowchart, if the user input is not a Deactivate( ); 

request to select an element, then the per-property browser GetPageInfo(LPPROPPAGEINFO pPagelnfo); 

determines if the user input is a request to activate the S etObjects(ULONG cObjects, LPUNKNOWN FAR* 

property sheet page map button (step 92). If the user input \y 

is a request to activate a property sheet page map button, 5 PP UD 

then the user desires to view the currently selected property Show(UINT nCmdShow); 

on a property sheet page. The per-property browser calls the Move(LPCRECT prect); 

MapPropertyToPage ( ) function to display the currently IsPageDirty( ); 

selected property on a property sheet page (step 93). In AdoIW V 

particular, the per-property browser calls the MapProperty- pp 

ToPage ( ) function to obtain an application defined property Help(LPCOLhS Ik IpszHelpDir); 

sheet page identifier for a property sheet page. Then, the TranslateAccelerator(LPMSG lpMsg); }; 

per-property browser invokes the property sheet page The property sheet page browser calls the SetPageSite ( ) 

browser, passing to it the class identifier returned by the function to provide the application defined property sheet 

MapPropertyToPage ( ) function. Then, the property may be page with the site object it should use to communicate with 

edited on a property sheet page (step 94). If the user input 15 the property sheet page browser. For instance, the applica- 

is a request to edit (step 95), then the per-property browser tion defined property sheet page would use the site object to 

allows editing (step 94). Editing is done by moving to the obta j n information from the property sheet page browser 

current property value of a property, using either arrow keys such as which language the application defined property 

or a mouse, and then manually changing the current property sheet page should ^ for displaymg its contents. The 

value. If the user input is anything else, the per-property 20 pr0 p er ty sheet page browser calls the Activate () function to 

browser jgnores the user input and loops to receive more proyide me application defined property sheet page ^ 

in *FIG 10 " fl h rt f mult' le selection within er information on where to display itself. The property sheet 

properly brotsug° Multiple selection allows a user to view P a Sf. brows « ,he Sbow ( ) Moa '° ^ 

{he common properties of several objects at once. First, the « "PP^Uon defined property sheet page or to hide it. The 

per-property browser receives a plurality of objects (step P ro P ert y sheet P a & 6 browser caUs the Deactivate ( ) function 

97). Then, the per-property browser determines which prop- to destr °y tne ^sources created by a preceding call to the 

erties the objects have in common (step 98). Then the Activate () function^ The property sheet page browser calls 

per-property browser displays the common properties in a the GetPagelnfo ( ) function to obtain information about the 

per-property browsing list (step 99). 30 application defined property sheet page, such as the apph- 

FIG. 11A and FIG. 11B show a flowchart that provides an ca,lon deflned P ro P ert y sheet P a S e s,ze and whether the 

overview of the steps performed to add application defined application defined property sheet page supports the help 

property sheet pages to a set of system defined property Action. The property sheet page browser calls the SetOb- 

sheet pages for an object. First, the property sheet page j ects ( ) faction to pass to the application defined property 

browser must obtain an interface pointer to the ISpeci- , s sheet P a S e a ** of ob j ects 50 mat the application defined 

fyPropertyPages interface of the object whose properties are property sheet page knows what objects to get property 

to be browsed (step 100). The ISpecifyPropertyPages inter- . values from and apply modifications made by a user while 

face is denned as follows. editin 8 t0 ( e *- in case of multl P le selection, multiple 

interface ISpecifyPropertyPages: IUnknown o^* 5 are The property sheet page browser calls 

i the Move ( ) function to move or resize the application 

GetPages(CAUUID FAR* pPages); }; *° defined ^ eet The property sheet page 

The GetPages function returns a list of identifiers to the browser calk ; the IsPageD,rt y () function todetermine if the 

application defined property sheet pages associated with an "ser modified the application defined property sheet page. If 

object. Once the property sheet page browser obtains the ^cations were made, then the property sheet page 

ISpecifyPropertyPages interface pomter, the property sheet 45 browser enab1 '* tbe Apply button. The property sheet page 

page browser calls The GetPages function to obtain a list of bro fi wse ; calls ,he ^ < > ^f 1100 t0 teU * e aPP - ? 

i- *• j c j . u * a / ♦ defined property sheet page to apply modifications to 

application defined property sheet page identifiers (step . £ K 7 _ u . < n .u « i / \ 

- objects. The property sheet page browser calls the Help ( ) 

Using the application defined property sheet page <f n fi cli ° n t0 dis P la y beI P inflation about the application 
identifiers, the property sheet page browser adds each appli- 50 defined P r °P e ,fx FT ■ , P W ? 
cation defined property sheet page to the current set of brows « caUs , the TranslateAccelerator (. function to corn- 
property sheet pages, which already contain system defined mu fi mca , ,e certam wmdow messa S es wltb tbe application 
property sheet pages. The property sheet page browser defi A n f f d P r °P ert .y sbe h el P a S e - _ . , f . , 
selects the first application defined property sheet page Mtet ob ' a,n ' n S the lP">pertyPage interface pointer, he 
identifier (step 104) Then the property sheet page browser 55 ST" y . k ^-T" ^ ? ° ( } 
creates an instance of an application defined property sheet ^ cllon }° obtam ?PP hc * ,on d f ned P ro P ert y sh f . P»f 
page for that application defined property sheet page iden- f f rma,,on ( s,e P 110 )- ^ ">f°™ation is stored in the 
tifier (step 106). Next, the property sheet page browser following data st ™*«- 
obtains an interface pointer to IPropertyPage which is typedef struct tagPROPPAGEINFO 
supported by the application defined property sheet page 60 \ 
(step 108). The IPropertyPage interface is defined as fol- size__t cb; 
lows. LPOLESTR pszTitle; 

interface IPropertyPage: IUnknown SIZE size; 

{ LPOLESTR pszDocString; 

SetPageSite(LPPROPERTYPAGESITE pPageSite); 6 5 LPOLESTR pszHelpFile; 

Activate(HWND hwndParent, LPCRECT lprc, BOOL DWORD dwHelpContext; 

bModal); } PROPPAGEINFO; 
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This application defined property sheet page information 
includes pszlitle, which is the title of the application defined 
property sheet page, size, which is the application defined 
property sheet page size, and pszHelpfilehich is a help file 
for the application defined property sheet page. 

Next, the property sheet page browser determines the 
location of the application defined property sheet page (step 
112) on the display. The property sheet page browser pro- 
vides this location information to the application defined 
property sheet page (step 114). The property sheet page 
browser then calls the SetPageSite ( ) function to give the 
application defined property sheet page a means of commu- 
nicating with the property sheet page browser (step 116). 
After this, the property sheet page browser calls the SetO- 
bjects ( ) function to provide the application defined property 
sheet page with the set of objects to which it applies 
modifications made by a user (step 118). That is, more than 
one object may support the same application defined prop- 
erty sheet page, and if this is the case, then an application 
defined property sheet page which is modified applies the 
modifications to each object which supports the application 
defined property sheet page. Following this, the property 
sheet page browser calls the Activate ( ) function to activate 
an application defined property sheet page (step 120). Next, 
the property sheet page browser calls the Show ( ) function 
to display the application defined property sheet page (step 
122). Once the Show ( ) function is called, the application 
defined property sheet page appears to be at the front of what 
appears to be a set of tabbed index cards. Then the property 
sheet page browser determines whether there are more 
application defined property sheet page identifiers (step 
124), and if there are, it selects the next application defined 
property sheet page identifier and processes it to add another 
application defined property sheet page to its set of property 
sheet pages (step 126), else it returns. 

FIG. 12 is a flowchart that provides the steps performed 
to edit properties on an application defined property sheet 
page. First, the application defined property sheet page 
obtains a pointer to the IPropertyPageSite interface, which is 
supported by the application defined property sheet page 
(step 140). The IPropertyPageSite interface is defined as 
follows. 

interface IPropertyPageSite: IUnknown 
{ 

OnStatusChange(DWORD flags); 
GetLocaleID(LCID FAR* pLocalelD); 
GetPageContainer(LPUNKNOWN FAR* ppUnk); 
Tr anslateAccelerator(LPMSG lpMsg) ; 

} 

The application defined property sheet page calls the 
OnStatusChange function to inform the property sheet page 
browser that the user made modifications while editing. The 
application defined property sheet page calls the GetLoca- 
lelD ( ) function to learn what language to use for displaying 
its, contents. The application defined property sheet page 
calls the GetPage Container ( ) function to get access to the 
per-property browser if the application defined property 
sheet page has some special knowledge about what inter- 
faces are supported by the property sheet page browser. The 
property sheet page calls the TranslateAccelerator ( ) func- 
tion to communicate certain window messages with the 
property sheet page browser. 

Continuing with the flowchart, when the user has modi- 
fied an application defined property sheet page, the property 
sheet page informs the property sheet page browser that the 
user modified the application defined property sheet page by 
calling the function OnStatusChange ( ) (step 142). In 
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response to this, the property sheet page browser calls the 
IsPageDirty ( ) function to confirm that the user has made a 
change (step 144). If the user has made a change to the 
property sheet page, the property sheet page browser enables 

5 the Apply button (step 146). When the Apply button is 
enabled, if a user selects the Apply button, the modifications 
the user made, while editing, to the application defined 
property sheet page are applied to the set of objects sup- 
porting that application defined property sheet page. After 

lQ enabling the Apply button, the property sheet page browser 
determines whether the user activated the apply button (step 
148). If the user did activate the apply button, then the 
property sheet page browser calls the Apply ( ) function (step 
150), else it returns. Calling the Apply ( ) function tells the 
application defined property sheet page to apply the modi- 

15 fications to the set of objects it received from the SetObjects 
( ) function (step 118 of FIG. 11B). 

FIG. 13 is a flowchart of the property sheet page browser 
when it enables switching from an application defined 
property sheet page to a per-property browsing list. A 

20 particular application defined property sheet page imple- 
ments the user interface for a per-property browsing list 
(step 170). Then, the property sheet page browser deter- 
mines whether a user requested the per-property browsing 
list (step 172). If a user did request the list, the property sheet 

25 page browser calls the Show ( ) function to show the 
application defined property sheet page which implements 
the user interface for a per-property browsing list (step 174), 
else it returns. 

FIG. 14 is a flowchart of multiple selection within per- 

3 q property browsing. Multiple selection allows a user to view 
the common application defined properties of several objects 
at once. First, the property sheet page browser receives a 
plurality of objects (step 180). Then, the property sheet page 
browser determines which application defined properties the 
objects have in common (step 182). Then the property sheet 

35 page browser displays the common application defined 
properties on a per-property browsing list (step 184). 

FIG. 15 is a flowchart of multiple selection by a property 
sheet page browser. Multiple -selection allows a user to view 
the common properties of several objects at once. First, the 

40 property sheet page browser receives a plurality of objects 
(step 190). Then, the property sheet page browser deter- 
mines which property sheet pages the objects have in 
common (step 192). Then the property sheet page browser 
displays the common property sheet pages (step 194). 

45 Although the methods and systems of the present inven- 
tion have been described in terms of a preferred 
embodiment, it is not intended that the invention be limited 
to this embodiment. Modifications within the spirit of the 
invention will be apparent to those skilled in the art The 

5 q scope of the present invention is defined only by the claims 
that follow. 
What is claimed is: 

1. A method performed by a computer system having a 
processor, a display device and an application development 
55 environment for developing application programs, the 
method comprising: 

providing a per-property browser as part of the applica- 
tion development environment for displaying a group 
of identifiers of properties and values of the properties 
60 for objects on the display device for editing by a user; 
providing a selected object having a first property of a first 
property type that the per-property browser can display 
for editing, wherein the first property has an identifier 
and a value; 

65 displaying the identifier and the value of the first property 
of the object as part of a browsing list on the display 
device for editing; 
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providing an associated property sheet page as part of the 
application development environment for displaying a 
group of identifiers of properties and values of the 
properties for objects on the display device for editing 
by a user; and 5 

determining whether the identifier and the value of the 
first property are also displayable on a property sheet 
page associated with the object. 

2. The method of claim 1 further comprising: 
providing a property sheet page map button on the brows- 10 

ing list, that when activated by a user causes displaying 
of the property sheet page containing the identifier and 
the value of the first property, when the identifier and 
the value of the first property are also displayable on a 
property sheet page associated with the object. 

3. The method of claim 2 further comprising: 
receiving user input to activate the first property sheet 

page map button; and 
in response to the user input, displaying the property sheet 
page for the object on which the identifier and the value 20 
of the first property are displayed. 

4. The method of claim 2 further comprising: 
providing program instructions for causing the identifier 

and the value of the first property to be displayed as part 

of the property sheet page; 2 5 
receiving user input to activate the property sheet page 

map button; 
calling the provided program instructions; and 
displaying the property sheet page with the identifier and 

the value of the first property. 30 

5. The method of claim 1 wherein the object has a second 
property of a second property type that the per-property 
browser can display for editing, the second property having 
an identifier and a value, the method further comprising: 

displaying the identifier and the value of the second 35 
property of the object as part of the browsing list on the 
display device for editing; 

determining whether the identifier and the value of the 
second property are also displayable on a property 
sheet page associated with the object; and 40 

providing a property sheet page map button on the brows- 
ing list, that when activated by a user causes displaying 
of the property sheet page containing the identifier and 
the value of the first property and the identifier and the 
value of the second property, when the identifier and 
the value of the first property and the identifier and 
value of the second property are also displayable on a 
property sheet page associated with the object. 

6. The method of claim 5 further comprising: 
receiving user input to activate the property sheet page 

map button; and 
in response to the user input, displaying the property sheet 
page for the object on which the identifier and the value 
of the first property and the identifier and the value of 
the second property are displayed. 

7. The method of claim 5 further comprising: 
providing program instructions for causing the identifier 

and the value of the first property and the identifier and 

the value of the second property to be displayed as part 60 

of the property sheet page; 
receiving user input to activate the property sheet page 

map button; 
calling the provided program instructions; and 
displaying the property sheet page with the identifier and 65 

the value of the first property and the identifier and the 

value of the second property. 
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8. A method performed by a computer system having a 
processor, a display device and an application development 
environment for developing application programs, the 
method comprising: 

providing a per-property browser as part of the applica- 
tion development environment for displaying a group 
of identifiers of properties and values of the properties 
for objects on the display device for editing by a user; 

providing a selected object having a first property of a first 
property type that the per-property browser can display 
for editing and a second property of a second property 
type that the per-property browser can display for 
editing, wherein the first property has an identifier and 
a value and the second property has an identifier and a 
value; 

with the per-property browser, displaying the identifiers 
and the values of both the first property and the second 
property of the object as part of a browsing list on the 
display device for editing; 

providing an associated property sheet page as part of the 
application development environment for displaying a 
group of identifiers of properties and values of the 
properties for objects on the display device for editing 
by a user; and 

determining whether the identifier and the value of the 
both the first property and the second property are also 
displayable on a property sheet page associated with 
the object. 

9. The method of claim 8 further comprising: 
providing a property sheet page map button on the brows- 
ing list, that when activated by a user causes displaying 
of the property sheet page when the identifier and the 
value of the first property and the identifier and the 
value of the second property are also displayable on the 
property sheet page. 

10. The method of claim 9 further comprising: 
receiving user input to activate the property sheet page 

map button; and 
in response to the user input, displaying the property sheet 
page for the object on which the identifier and the value 
of the first property and the identifier and the value of 
the second property are displayed. 

11. The method of claim 9 further comprising: 
providing program instructions for causing the identifier 

and the value of the first property and the identifier and 

the value of the second property to be displayed as part 

of the property sheet page; 
receiving user input to activate the property sheet page 

map button; 
calling the provided program instructions; and 
displaying the property sheet page with the identifier and 

the value of the first property and the identifier and the 

value of the second property. 

12. A property browsing system for browsing objects in a 
program under development in a computer system having a 
processor, a display device and an input device, the brows- 
ing system comprising: 

a per-property browser for displaying a group of identi- 
fiers of properties and values of the properties for 
objects on the display device for editing by a user; 

a selected object having a first property of a first property 
type that the per-property browser can display for 
editing and a second property of a second property type 
that the per-property browser can display for editing, 
wherein the first property has an identifier and a value 
and the second property has an identifier and a value; 
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the per-property browser, displaying the identifiers and 
the values of both the first property and the second 
property of the object as part of a browsing list on the 
display device for editing; 

an associated property sheet page having a group of 
identifiers of properties and values of the properties for 
objects on the display device for editing by a user; and 

the processor determining whether the identifier and the 
value of both the first property and the second property 
are also displayable on a property sheet page associated 
with the object. 

13. The system of claim 12 further comprising: 

a property sheet page map button on the browsing list; 

in response to activation of the property sheet page map 
button by a user through the input device, the processor 
displays on the display device the property sheet page 
with the identifier and the value of both the first 
property and the second property when both are dis- 
playable on the property sheet page. 

14. The system of claim 13 further comprising: 

a drop down list button on the browsing list for a property; 

in response to activation of the drop down list button by 
user input through the input device, the processor 
displays on the display device a drop down list of 
possible values for the property. 

15. A computer program product readable by a computer 
system and encoding a computer program of instructions for 
executing a computer process, the computer system having 
a processor, a display device and an application develop- 
ment environment for developing application programs, said 
computer process comprising: 

providing a per-property browser as part of the applica- 
tion development environment for displaying a group 
of identifiers of properties and values of the properties 
for objects on the display device for editing by a user; 

providing a selected object having a first property of a first 
property type that the per-property browser can display 
for editing, wherein the first property has an identifier 
and a value; 

displaying the identifier and the value of the first property 
of the object as part of a browsing list on the display 
device for editing; 

providing an associated property sheet page as part of the 
application development environment for displaying a 
group of identifiers of properties and values of the 
properties for objects on the display device for editing 
by a user; and 

determining whether the identifier and the value of the 
first property are also displayable on a property sheet 
page associated with the object. 

16. The computer process in the computer program prod- 
uct of claim 15 further comprising: 

providing a property sheet page map button on the brows- 
ing list, that when activated by a user causes displaying 
of the property sheet page containing the identifier and 
the value of the first property, when the identifier and 
the value of the first property are also displayable on a 
property sheet page associated with the object. 

17. The computer process in the computer program prod- 
uct of claim 16 further comprising: 

receiving user input to activate the first property sheet 

page map button; and 
in response to the user input, displaying the property sheet 

page for the object on which the identifier and the value 

of the first property are displayed. 



10 



is 



20 



25 



30 



35 



45 



50 



55 



60 



65 



18. The computer process in the computer program prod- 
uct of claim 15 wherein the object has a second property of 
a second property type that the per-property browser can 
display for editing, the second property having an identifier 
and a value, said computer process further comprising: 

displaying the identifier and the value of the second 
property of the object as part of the browsing list on the 
display device for editing; 

determining whether the identifier and the value of the 
second property are also displayable on a property 
sheet page associated with the object; and 

providing a property sheet page map button on the brows- 
ing list, that when activated by a user causes displaying 
of the property sheet page containing the identifier and 
the value of the first property and the identifier and the 
value of the second property, when the identifier and 
the value of the first property and the identifier and 
value of the second property are also displayable on a 
property sheet page associated with the object. 

19. The computer process in the computer program prod- 
uct of claim 18 further comprising: 

receiving user input to activate the property sheet page 

map button; and 
in response to the user input, displaying the property sheet 

page for the object on which the identifier and the value 

of the first property and the identifier and the value of 

the second property are displayed. 

20. A computer program product readable by a computer 
system and encoding a computer program of instructions for 
executing a computer process, the computer system having 
a processor, a display device and an application develop- 
ment environment for developing application programs, said 
computer process comprising: 

providing a per-property browser as part of the applica- 
tion development environment for displaying a group 
of identifiers of properties and values of the properties 
for objects on the display device for editing by a user; 

providing a selected object having a first property of a first 
property type that the per-property browser can display 
for editing and a second property of a second property 
type that the per-property browser can display for 
editing, wherein the first property has an identifier and 
a value and the second property has an identifier and a 
value; 

with the per-property browser, displaying the identifiers 
and the values of both the first property and the second 
property of the object as part of a browsing list on the 
display device for editing; 

providing an associated property sheet page as part of the 
application development environment for displaying a 
group of identifiers of properties and values of the 
properties for objects on the display device for editing 
by a user; and 

determining whether the identifier and the value of the 
both the first property and the second property are also 
displayable on a property sheet page associated with 
the object. 

21. The computer process in the computer program prod- 
uct of claim 20 further comprising: 

providing a property sheet page map button on the brows- 
ing list, that when activated by a user causes displaying 
of the property sheet page when the identifier and the 
value of the first property and the identifier and the 
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value of the second property are also displayable on the 

property sheet page. 
22. The computer process in the computer program prod- 
uct of claim 21 further comprising: 

receiving user input to activate the property sheet page 

map button; and 
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in response to the user input, displaying the property sheet 
page for the object on which the identifier and the value 
of the first property and the identifier and the value of 
the second property are displayed. 
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